Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Convert resources into static site #5

Merged
merged 3 commits into from Sep 16, 2019
Merged

Conversation

Nolski
Copy link
Collaborator

@Nolski Nolski commented Sep 5, 2019

Hi all, for reference, this PR seeks to address issue #3. I wanted to start from an existing template to minimize the amount of work going into this issue and unfortunately, it seems that Jekyll templates are often proprietary. Instead, I decided to use a similar static site generator hugo. It's proven quite easy to use and had a great template to build our site off of.

You can find an example of the site running (same code & resources) here: https://nolski.github.io/example-librecorps-site/

There are still parts to fill in but I wanted to at least get the basics PR'd and submitted in order to get initial feedback.

Content Structure

As we have used markdown for majority of notes, I think keeping our notes in markdown is a good idea for now. We have six categories that we will be putting our resources into. You can find those categories below and the corrosponding resources:

├── [ 4.0K]  ai/
│   ├── [  206]  _index.en.md
│   ├── [ 3.3K]  milestone-roadmap.md
│   ├── [ 2.5K]  model-card.md
│   └── [ 2.2K]  traps.md
├── [ 4.0K]  community/
│   ├── [  214]  _index.en.md
│   └── [ 2.8K]  reading-list.md
├── [ 4.0K]  legal/
│   ├── [ 2.3K]  cla.en.md
│   └── [  169]  _index.en.md
├── [ 4.0K]  outreach/
│   └── [  201]  _index.en.md
├── [ 4.0K]  product-management/
│   ├── [  186]  _index.en.md
│   └── [ 3.4K]  preliminary-interview-template.en.md
└── [ 4.0K]  tooling/
    └── [  189]  _index.en.md

Creating new resources

If you wish to create a new resource under a category. Simply create a new markdown file containing the info you wish to have in the resource. Make sure you prepend a header describing the resource as below:

---
title: "Title of the Resource"
date: 2019-09-03T11:02:05+06:00 # this is the date of the post
type: "post"
---
Rest of the resource goes here

@Nolski Nolski requested a review from jwflory September 5, 2019 10:10
@Nolski Nolski added the improvement Improves on something that already exists label Sep 5, 2019
Copy link
Member

@jwflory jwflory left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Awesome work @Nolski. Thanks for banging this out so fast. This PR is very large and since it contains the "initial" changes, I trust to deploy it first and then make smaller PRs if needed to fix things up.

My only change request is if you can please include the paragraph in this PR in a first header in a .github/CONTRIBUTING.md file for this repo. We'll definitely need to reference the headers again so it would be good to document them where GitHub gives more visibility in the UI.

Otherwise, I am 👍 merging this in!

@Nolski
Copy link
Collaborator Author

Nolski commented Sep 16, 2019

Hey @jwflory I'm not sure I understood what you were asking correctly but I added the overview of the directory structure to .github/CONTRIBUTING.md. Let me know if that's what you wanted or if you meant something else and I'll be happy to modify :)

Copy link
Member

@jwflory jwflory left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Super, everything looks set to me! 👍 Ready to merge this. 🌊

@jwflory jwflory merged commit 4284bd5 into librecorps:master Sep 16, 2019
@jwflory jwflory linked an issue Mar 19, 2020 that may be closed by this pull request
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
improvement Improves on something that already exists
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Convert markdown resources to Jekyll web pages
2 participants